package com.xci.platform.auth.dao;

import com.xci.platform.auth.entity.ModuleEntity;
import com.xci.platform.core.ITreeOperate;
import com.xci.platform.core.Tree;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 系统模块数据访问接口
 */
@Mapper
public interface ModuleDao extends ITreeOperate {

    /**
     * 新增模块
     *
     * @param entity 模块对象
     * @return 返回影响的行数
     */
    Integer insert(@Param("entity") ModuleEntity entity);

    /**
     * 更新模块
     *
     * @param entity 模块对象
     * @return 返回影响的行数
     */
    Integer update(@Param("entity") ModuleEntity entity);

    /**
     * 删除模块
     *
     * @param id 模块主键
     * @return 返回影响的行数
     */
    Integer delete(@Param("id") String id);

    /**
     * 根据主键更新排序路径
     *
     * @param id   主键
     * @param path 排序路径
     */
    Integer updatePathById(@Param("id") String id, @Param("path") String path);

    /**
     * 根据主键更新父节点以及排序路径
     *
     * @param id       主键
     * @param parentId 上级主键
     * @param path     排序路径
     */
    Integer updateParentAndPathById(@Param("id") String id, @Param("parentId") String parentId, @Param("path") String path);

    /**
     * 根据主键更新叶子节点状态
     *
     * @param id   主键
     * @param leaf 叶子节点状态
     */
    Integer updateLeafById(@Param("id") String id, @Param("leaf") Integer leaf);

    /**
     * 更新模块启用状态
     *
     * @param id     模块主键
     * @param status 是否启用(1:启用 0:禁用)
     */
    Integer updateStatus(@Param("id") String id, @Param("status") Integer status);

    /**
     * 验证指定模块编码是否存在
     *
     * @param code     模块编码
     * @param id       模块主键
     * @return 如果存在返回true, 否则返回false
     */
    Integer existByCode(@Param("code") String code, @Param("id") String id);

    /**
     * 根据模块主键获取模块对象
     *
     * @param id 模块主键
     * @return 返回指定模块主键的模块对象
     */
    ModuleEntity queryById(@Param("id") String id);

    /**
     * 根据用户主键获取模块列表
     * @param userId 用户主键
     */
    List<ModuleEntity> queryByUser(@Param("userId") String userId);

    /**
     * 根据角色主键获取模块列表
     * @param roleId 角色主键
     */
    List<ModuleEntity> queryByRole(@Param("roleId") String roleId);

    /**
     * 获取模块名称
     *
     * @param id 模块主键
     * @return 模块名称
     */
    String queryNameById(@Param("id") String id);

    /**
     * 获取指定主键的排序路径
     *
     * @param id 主键
     */
    String queryPathById(@Param("id") String id);

    /**
     * 获取指定主键的子节点数
     *
     * @param id 主键
     */
    Integer queryChildCountById(@Param("id") String id);

    /**
     * 查询模块列表
     *
     * @return 返回符合查询条件的模块列表
     */
    List<ModuleEntity> query();

    /**
     * 动态加载模块列表
     *
     * @param id 模块主键
     * @return 模块列表
     */
    List<ModuleEntity> dynamicQuery(@Param("id") String id);

    /**
     * 查询Tree模型列表
     */
    List<Tree> queryTreeModelList();
}
